home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir35 / apdz27.zip / APP-DIZ.DOC next >
Text File  |  1993-04-24  |  15KB  |  418 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.    ██████████                                 █████████
  15.    ██      ██                                 ██       ██   ██
  16.    ██      ██                                 ██       ██
  17.    ██████████  ██████████  ██████████         ██       ██   ██   ███████
  18.    ██      ██  ██      ██  ██      ██  █████  ██       ██   ██        ▄
  19.    ██      ██  ██      ██  ██      ██         ██       ██   ██    ▄ ▀
  20.    ██      ██  ██████████  ██████████         █████████     ██   ███████
  21.                ██          ██
  22.                ██          ██
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                         Apply-Diz by Dataware Software
  30.  
  31.                                  Version 2.7
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                
  44.                                 
  45.                                Copyright (C) 1992-93
  46.                                         by
  47.                                     Tom Carroll
  48.  
  49.  
  50.                                 All rights reserved
  51.  
  52.  
  53.  
  54.                                  The Data Shop BBS
  55.                             (509)582-9493 (HST/DS 16.8)
  56.                                    Kennewick, WA
  57.                               FIDO address (1:347/110)
  58.  
  59.                               MAGIC FILE NAME: APPDIZ
  60.     ┌──────────────┐
  61.     │ INTRODUCTION │
  62.     └──────────────┘
  63.  
  64.     Apply-Diz is a utility designed to ease the burden of sysops trying to 
  65.     describe files, that either had their descriptions lost in the process of
  66.     a file transfer, or they are old enough that you just can't remember.  It
  67.     places the burden of describing files back onto the users and authors that
  68.     upload files without a description file such as FILE_ID.DIZ or DESC.SDI in
  69.     which Apply-Diz will make a FILE_ID.DIZ from the user supplied description
  70.     and compress it into the archive.  Apply-Diz can automatically detect
  71.     archives by signature, and extract or compress into the archive based on
  72.     this signature, no more relying on file suffixes.
  73.     
  74.     Apply-Diz has two purposes, one is to enhance the service that some of the
  75.     larger BBS's offer by insuring no matter what kind of file or archive
  76.     received on their system, either uploaded by users, downloaded from another
  77.     BBS, or copied to the system from monthly mailings, Apply-Diz will make
  78.     sure that two descriptions exist for the archive, one in the PCBoard(tm)
  79.     directory format, and the other in a FILE_ID.DIZ. (one of the two has to
  80.     exist, but neither one is overwritten if they both exist.)  This is a very
  81.     appealing feature that other sysops will appreciate if they subscribe to
  82.     your BBS and download your files for use on their systems.
  83.  
  84.     Two is the major reason Apply-Diz was invented.  I run a BBS, and I really
  85.     don't have all the time in the world to mess around with file descriptions,
  86.     and since I'm a programmer I tend to hold on to old archives, and then
  87.     forget what they are.  So I decided to cut half my workload and just write
  88.     a utility. (hmmm...  what am I saying?)
  89.     
  90.     You're probably asking your self "What is this guy babbling about?"  Well,
  91.     it's time to cut to the chase and show you how to operate it...
  92.  
  93.     ┌──────────────┐
  94.     │  DISCLAIMER  │
  95.     └──────────────┘
  96.  
  97.     This software is provided as is without warranty or guarantee either
  98.     expressed or implied.  The author will not be held responsible for ANY
  99.     damages that may result in the use of this program, including revenues
  100.     lost.  The Author will, however, be responsible for a full refund of the
  101.     purchasers registration cost should the software not be capable of
  102.     operating on the purchasers computer.
  103.  
  104.     Apply-Diz software and this document are Copyright (C) 1992 by Tom Carroll. 
  105.     All rights reserved.
  106.  
  107.     ┌──────────────┐
  108.     │   LICENSE    │
  109.     └──────────────┘
  110.  
  111.     This program is released as SHAREWARE.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.     Apply-Diz v2.7                                                       Page 2
  119.     You are free to use this version of the program for a period of 30 days,
  120.     upon which, you must either register the software, or delete it from your
  121.     system with the exception of the original archive, which may be freely
  122.     distributed as outlined below.  Please refer to the ORDER.FRM included in
  123.     the distribution archive for registration information.
  124.  
  125.     No one may alter, modify, or reverse engineer Apply-Diz for any reason,
  126.     including but not limited to decompiling-compiling, patching, or
  127.     disassembling.
  128.  
  129.     You may freely distribute & copy this program for others subject to the
  130.     above restrictions and the following:
  131.  
  132.          ■ Apply-Diz is copied in unmodified form including this file. 
  133.          ■ There is no charge for copying except for the cost of disks.
  134.          ■ Apply-Diz is not included in another software package without
  135.            the express written permission of Tom Carroll
  136.  
  137.     You may operate Apply-Diz on one computer system at a time, one computer
  138.     system is defined as a single XT/AT/PC which operates solely by itself, or
  139.     multi-node BBS running the same BBS software and all nodes are connected
  140.     to a central file server.
  141.  
  142.     Should Apply-Diz need to be operated on more that one computer system, a
  143.     site license will be negotiated.
  144.  
  145.     ┌──────────────┐
  146.     │   SUPPORT    │
  147.     └──────────────┘
  148.  
  149.     If you should find any problems with this program, or you have any requests
  150.     or recommendations, you may reach me on my BBS, or at the FIDO address
  151.     listed on the front cover.  I may also be reached in the FIDO PCBNET,
  152.     SaltAir, UN'I, ILink, Global-Net, or Source-Net sysop conferences.
  153.  
  154.     ┌──────────────┐
  155.     │    FILES     │
  156.     └──────────────┘
  157.  
  158.     Files included in this archive:
  159.  
  160.               APP-DIZ.DOC  - This manual
  161.               APP-DIZ.ERR  - Sample error file
  162.               APP-DIZ.EXE  - The Apply-Diz executable
  163.               APP-DIZ.HIS  - Apply-Diz History information file
  164.               APP-DIZ.LOG  - Sample log file
  165.               APP-DIZ.XLD  - Sample exclude file
  166.               FILE_ID.DIZ  - Description file for Apply-Diz
  167.               ORDER.FRM    - Registration form & ordering info
  168.               PROGRAMS.DWS - Other programs by Dataware Software
  169.  
  170.     I originally compressed this program as APDZnn.ARJ, but it may be
  171.     compressed with any other archive program you wish to use.
  172.  
  173.     The latest version will always be available on my BBS using the magic
  174.     filename of APPDIZ.
  175.  
  176.  
  177.     Apply-Diz v2.7                                                       Page 3
  178.     Sometimes, there may be a need for debug code to be released.  This code is
  179.     used to track down specific problems which aren't normally encountered on
  180.     my system.  I have a 386/sx-25 w/4megs of RAM, and DOS 5.0, which should be
  181.     pretty standard and generic, but sometimes this doesn't present an
  182.     optimal testing environment, so please, if you're having problems, and
  183.     debug code is available, feel free to FREQ APDEBUG from me, or if you're
  184.     registered on my BBS call and download APPDIZ.ARJ from conference #1.
  185.  
  186.     If APPDIZ.ARJ isn't available, then you're the first person that has
  187.     found a problem, so please leave me your specifics so I may be able to
  188.     trouble shoot the problem(s).
  189.  
  190.     ┌──────────────┐
  191.     │  EXECUTION   │
  192.     └──────────────┘
  193.  
  194.     Apply-Diz is fully command line driven.
  195.  
  196.     The syntax for calling it is as follows:
  197.  
  198.     APP-DIZ <ARCHIVE> <PCBDIRLIST> { /Cx /INFO /NL /Rx /WKd: }
  199.  
  200.     <ARCHIVE> = Full path and filename(s) of the archive to be processed.
  201.  
  202.     <PCBDIRLIST> = Full PCBoard file directory listing to be processed.
  203.  
  204.     { Optional switches }
  205.  
  206.     /CD  = Process files in CD-ROM mode.  (Does not add FILE_ID.DIZ)
  207.     
  208.     /CF* = only checks for a FILE_ID.DIZ within the archive.
  209.  
  210.     /CP* = only checks for a description in the PCB DIR file.
  211.  
  212.     /INFO = Will add an archive information line to the PCBoard(tm) DIR list.
  213.             (i.e.  Files: nn Newest: mm-dd-yy Oldest: mm-dd-yy)
  214.  
  215.     /IO = Info line only.  (i.e. Files: nn Newest: mm-dd-yy Oldest: mm-dd-yy)
  216.  
  217.     /NL = Turns of the logging feature.  This is a good idea if you're going
  218.           to process a directory with many files.  It is on by default.
  219.  
  220.     /RF = Will overwrite the FILE_ID.DIZ file in the archive or create it if
  221.           it doesn't already exist.
  222.  
  223.     /RP = Will overwrite the PCBoard(tm) description with the FILE_ID.DIZ, or
  224.           DESC.SDI file within the archive.
  225.  
  226.     /WK = Allows Apply-Diz to use a work drive.  The drive must be specified
  227.           as DRIVE:.  (i.e.  /WKD: )
  228.  
  229.     /FMT = Lets you define how you want the info-line formatted.  This is a
  230.            new addition in version 2.7.  The use of this line is fairly simple
  231.            in that you only have to specify the following information to make
  232.            it work:
  233.  
  234.            /FMT:'</>@f<n>  @o<n>  @n<n>'
  235.  
  236.  
  237.     Apply-Diz v2.7                                                       Page 4
  238.            Now for an explaination of the /FMT switch.  In the use of this
  239.            command line switch, it must be followed by a colon ":" and a
  240.            single quote "'".  The next item (which must be the first character
  241.            after the single quote) is an optional forward slash "/" which
  242.            tells Apply-Diz to change the dashes "-" in the date format
  243.            04-24-93 to 04/24/93.
  244.  
  245.            The following macros tell Apply-Diz where to place the actual
  246.            words for the info line:
  247.  
  248.                 @f - The "Files:" word
  249.                 @o - The "Oldest:" word
  250.                 @n - The "Newest:" word
  251.  
  252.            When placing the macro's on the line, be aware that any spaces
  253.            placed between them will be included in the info-line (see note
  254.            below for overflow info).  For example:
  255.  
  256.            /FMT:'/@f  @o  @n'
  257.  
  258.            will produce:  Files: nn  Oldest: mm/dd/yy  Newest: mm/dd/yy
  259.            which places 2 spaces between the nn and Oldest: and the yy and
  260.            Newest:
  261.  
  262.            The final option is the <n> after each macro.  This tells Apply-Diz
  263.            how many spaces to place after the colon ":" for that macro.  For
  264.            example:
  265.  
  266.            /FMT:'@f2 @o2 @n2'
  267.  
  268.            will produce:  Files:  nn Oldest:  mm-dd-yy Newest:  mm-dd-yy
  269.            which places 2 spaces between the colon and the value.
  270.  
  271.            (note:  If the info-line should exceed 45 characters in length,
  272.             then all double spaced characters "  " will be reduced to a
  273.             single space until the line is 45 characters long)
  274.    
  275.    * - The /Cx switch is only used for speed.  If a file is found to not have
  276.        either description Apply-Diz will default to normal mode for that file.
  277.    
  278.    +Wild cards "*" may be specified on the command line for the archive file
  279.     name.  (i.e.  C:\UPLOAD\*.ARJ or C:\UPLOAD\*.* is valid)
  280.  
  281.  
  282.     You may at anytime during the processing of files press the <esc> key to
  283.     abort the process.  This really only has it's advantage in batch mode
  284.     operation since it will continue to process the present file it is working
  285.     on to ensure all open files are properly closed.
  286.  
  287.     ┌──────────────┐
  288.     │    NOTES     │
  289.     └──────────────┘
  290.  
  291.     At anytime, you may just type APP-DIZ without any command line arguments
  292.     and a help screen similar to this one will appear.
  293.  
  294.     You must specify the complete path for the archive name and the PCBoard
  295.     file directory listing.
  296.  
  297.     Apply-Diz v2.7                                                       Page 5
  298.    +In the registered version of App-Diz you may specify wild cards on the
  299.     command line for the processing of all files in one directory. (This is
  300.     refered to as Batch mode)
  301.  
  302.     If you are using an unregistered evaluation copy, insure you have command
  303.     line arguments correct if you run this utility in your nightly event
  304.     because there is a pause that requires input from the keyboard if they
  305.     are incorrect.
  306.  
  307.     Any description lines in the PCBoard directory that you do not wish to 
  308.     be included in the FILE_ID.DIZ may be excluded by adding the unique
  309.     beginning string for that line in the exclude file.  See the sample
  310.     APP-DIZ.XLD for more details.  This file must be named APP-DIZ.XLD and
  311.     located within the same directory as the executable.
  312.  
  313.     Apply-Diz will make a log file, or append to an existing one while
  314.     processing files.  Please refer to the enclosed sample log file.  Apply-Diz
  315.     will report each action/non-action taken on a particular file, and why it
  316.     didn't take any action if that is the case.  This file is not controlled
  317.     for size, so make sure you keep an eye on it, or it could grow very large
  318.     in a short amount of time.
  319.  
  320.     If an error should occur while processing the files, Apply-Diz will make a
  321.     report to an APP-DIZ.ERR file which will be located in the same directory
  322.     as the executable.  This too is appended for later viewing.  Again this
  323.     file isn't monitored for size either.
  324.     
  325.     ┌──────────────┐
  326.     │ LIMITATIONS  │
  327.     └──────────────┘
  328.  
  329.     Apply-Diz is incapable of scanning self extracting files at this time.  It
  330.     will skip all files that have the suffix's of .EXE, .COM, .TXT, .GIF, .PCX,
  331.     .SDA, and .TIC.  If you have problems with any other files making App-Diz
  332.     abort the process, please let me know and I will add code to not allow
  333.     those types of files to be scanned.
  334.  
  335.     Apply-Diz is NOT Desqview aware, or capable of working with locked files.
  336.     All PCBoard directories should be processed while all nodes are down.
  337.  
  338.     You must have the following archiver's for the defined archive types in
  339.     your path so Apply-Diz can manipulate it:
  340.  
  341.     ARC - ARC by System Enhancement Associates, Inc.
  342.     ARJ - ARJ by Robert K. Jung
  343.     LHA - LHARC by Haruyasu Yoshizaki
  344.     PAK - PAK by NoGate Consulting
  345.     ZIP - PKZip by PKWare, Inc.
  346.     ZOO - ZOO by Rahul Dhesi
  347.  
  348.     Apply-Diz must be executed from the current directory, or located somewhere
  349.     in your path statement.
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.     Apply-Diz v2.7                                                       Page 6
  358.     If a work drive is not specified Apply-Diz will create a work directory
  359.     off the root directory called APP-DIZ.  All logs and scratch files will
  360.     remain there until processing is completed or aborted.  If there is an
  361.     error during execution, all attempts are made to remove this directory
  362.     and clean all associated files.  The files created in the APP-DIZ
  363.     directory are:  TMP_ID.DIZ, FILE_ID.DIZ, APP-DIZ.LOG, and ARCINFO.LST.
  364.  
  365.     This software is fully functional.  However, there is a 20 second delay
  366.     after each execution.  Registration will remove this delay and also
  367.     allow the processing of all files within the specified directory known
  368.     as batch mode processing.
  369.  
  370.     These are the only limitations to this program.
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.     
  378.     
  379.     
  380.     
  381.     
  382.     
  383.     
  384.     
  385.     
  386.     
  387.     
  388.     
  389.     
  390.     
  391.     
  392.     
  393.     
  394.     
  395.     
  396.     
  397.     
  398.     
  399.     
  400.     
  401.     
  402.     
  403.     
  404.     
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.     Apply-Diz v2.7                                                       Page 7
  418.